home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc A) / Acorn User China CD-ROM (UK) (Disc A).bin / HENSA / FONTS / FONTMGR2.ARC / !FontMGR2_TechText_Scripts < prev    next >
Encoding:
Text File  |  1994-11-29  |  4.1 KB  |  178 lines
  1. !FontManager release two script format.
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4.  !Note! -> FILETYPE : &3f8.
  5.  
  6. -----------------------------------------------
  7.  
  8. The new scripts
  9. ~~~~~~~~~~~~~~~
  10.  
  11. This document describes the format for the
  12. current release and version of !FontMGR.
  13. Previous to release 2 the format was rather
  14. messy, and I have decided to make those files
  15. void now because of the huge improvement.
  16.  
  17. I may release a piece of software to convert
  18. to the new file format @ some later date.  If
  19. you need it urgently please contact me and I
  20. will consider doing it soon.
  21.  
  22. The new format is a script one, so you can
  23. edit in a text editor or wordprocessor.  This
  24. *WILL* make it easier for you to edit files,
  25. and create files.  The current format will be
  26. added to if required - THIS MEANS THIS IS
  27. MOST LIKELY PERMANENT -.  Also third parties
  28. are welcome to have their applications export
  29. font manager scripts.
  30.  
  31. Please use the supplied icon however.
  32.  
  33. -----------------------------------------------
  34.  
  35. Below is an example file generated by !FontMGR2
  36. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  37.  
  38. FMGR
  39.  
  40. # This file is a script for Font Manager release two version 0.050
  41. # Generated by !FontMGR2 version 0.050.
  42. # Date stamp : Sun Jul 31 15:52:50 1994
  43. *FILE_VERSION* : 0.01
  44.  
  45. *FLAGS*
  46. {
  47.  FONTINSTALL               : NO
  48.  ALL_ACTIVE                : NO
  49.  IMMEDIATE_CHANGES         : YES
  50.  SAVE_STATUS_ON_QUIT       : YES
  51.  UNLIMITED_PATHS           : YES
  52.  
  53.  OVERWRITE_FILES           : YES
  54.  EXPORT_AS_FILER_DIRECTORY : NO
  55.  EXPORT_AS_FONT_DIRECTORY  : YES
  56.  INSTALL_ON_VIEWING        : YES
  57. }
  58.  
  59. *GROUPS*
  60. {
  61.  Script
  62.  JustTestin
  63.  MuttonBird
  64.  Unique
  65.  Wail
  66.  General
  67. }
  68.  
  69. *SELECT* : Script
  70.  
  71.  
  72. *GROUP_ORDER*
  73. {
  74.  Wail
  75.  General
  76.  Script
  77.  JustTestin
  78.  MuttonBird
  79.  Unique
  80. }
  81.  
  82. *END*
  83.  
  84. -----------------------------------------------
  85.  
  86. Discussion on the above file.
  87. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  88.  
  89. The initial 'FMGR' signifies that a FontMGR2
  90. file is being considered - it is therefore
  91. essential!
  92.  
  93. Any comments come next preceeded by a '#'
  94.  
  95. The file version is set at 0.01 for now. This
  96. most likely won't change.
  97.  
  98. Next is the configuration flags.  If you have
  99. used !FontMGR2 then this will be obvious.
  100.  
  101. The next item, '*GROUPS*' is to describe which
  102. groups are active.
  103.  
  104. The '*SELECT*' item is to describe which group
  105. is the selected one.
  106.  
  107. The last item, with the exception of the '*END*'
  108. marker is the '*GROUP_ORDER*' one.  This is
  109. obviously used to define the order that groups
  110. should be in.
  111.  
  112. At the end it is imperitive that you include the
  113. '*END*' marker or else...
  114.  
  115. One important thing to note is the indentations,
  116. because they are *NOT* optional!  They are one
  117. space where required.  Please refer to the
  118. above example to see this important feature of
  119. Font Manager files.
  120.  
  121. -----------------------------------------------
  122.  
  123. Using the File Format - can I?
  124. ~~~~~~~~~~~~~~~~~~~~~
  125.  
  126. By giving you, the public a full description of
  127. this very very simple file format I hope that
  128. you will feel free to include the exporting of
  129. Font Manager scripts from your applications.
  130.  
  131. --==> PLEASE USE THIS FILE FORMAT !!! <==--
  132.  
  133. Also, it is essential that you maintain the
  134. file's iconsprite, and keep it attached to the
  135. filetype.  DO NOT CREATE YOUR OWN!!!!
  136.  
  137. I am aware of third-parties writing commerical
  138. font managers and I would be only too happy for
  139. them to also use this file format, and the
  140. font hunter feature below.  However please do
  141. not 'add' features to the file format without
  142. discussing the change with me first.
  143.  
  144. -----------------------------------------------
  145.  
  146. The Font Hunter
  147. ~~~~~~~~~~~~~~~~
  148.  
  149. The 'font hunter' feature is primarily designed
  150. to help programmers get their applications to
  151. integrate with FontMGR2.  Below is an example
  152. of how it might appear in a file.
  153.  
  154. *FONTS*
  155. {
  156.  NewYorker
  157.  Folio
  158.  Futura1
  159.  Olivia
  160. }
  161.  
  162. It's layout is similar to the "*GROUPS*" item.
  163. When the script is being 'read' by !FontMGR2,
  164. any groups that contain the listed fonts are
  165. turned on.
  166.  
  167. This is the 'engine' of application support
  168. of !FontMGR2 and also is the means by which
  169. DocScan works.
  170.  
  171. This may also be useful for people moving files
  172. from computer to computer.  Saving a "*FONTS*"
  173. version of a script is now supported via the
  174. Font Manager 2 interface.
  175.  
  176. -----------------------------------------------
  177.  
  178.